Developer Documentation

QuickTime 4 API Documentation

3D Graphics Programming with QuickDraw 3D 1.5.4

Previous | QD3D Book | Overview | Chapter Contents | Next |

Managing Picking ID Styles

QuickDraw 3D provides routines that you can use to manage picking ID styles.

Q3PickIDStyle_New

You can use the Q3PickIDStyle_New function to create a new picking ID style object.

TQ3StyleObject Q3PickIDStyle_New (unsigned long id);
id
A picking ID.

DESCRIPTION

The Q3PickIDStyle_New function returns, as its function result, a new style object having the picking ID specified by the id parameter. If a new style object could not be created, Q3PickIDStyle_New returns the value NULL .

SEE ALSO

See "Picking ID Styles" for a description of picking ID styles.

Q3PickIDStyle_Submit

You can use the Q3PickIDStyle_Submit function to submit a picking ID style in immediate mode.

TQ3Status Q3PickIDStyle_Submit (
                     unsigned long id,
                     TQ3ViewObject view);
id
A picking ID.
view
A view.

DESCRIPTION

The Q3PickIDStyle_Submit function sets the picking ID of the view specified by the view parameter to the value specified by the id parameter.

SPECIAL CONSIDERATIONS

You should call Q3PickIDStyle_Submit only in a submitting loop.

Q3PickIDStyle_Get

You can use the Q3PickIDStyle_Get function to get the picking ID style value of a picking ID style.

TQ3Status Q3PickIDStyle_Get (
                     TQ3StyleObject pickIDObject,
                     unsigned long *id);
pickIDObject
A picking ID style object.
id
On exit, the picking ID of the specified picking ID style object.

DESCRIPTION

The Q3PickIDStyle_Get function returns, in the id parameter, the current picking ID of the style object specified by the pickIDObject parameter.

Q3PickIDStyle_Set

You can use the Q3PickIDStyle_Set function to set the picking ID of a picking ID style.

TQ3Status Q3PickIDStyle_Set (
                     TQ3StyleObject pickIDObject,
                     unsigned long id);
pickIDObject
A picking ID style object.
id
A picking ID.

DESCRIPTION

The Q3PickIDStyle_Set function sets the picking ID of the style object specified by the pickIDObject parameter to the value specified in the id parameter.

© 1997 Apple Computer, Inc.

Previous | QD3D Book | Overview | Chapter Contents | Next |